package com.example.pcl.service;

import com.example.pcl.pojo.dto.StudentQueryDto;
import com.example.pcl.pojo.entity.Students;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.pcl.result.PageResult;

import java.io.ByteArrayOutputStream;
import java.util.List;

/**
 * <p>
 * 学生表，存储学生个人信息，包括学号，年级和学院 服务类
 * </p>
 *
 * @author xx
 * @since 2024-12-17
 */
public interface IStudentsService extends IService<Students> {

    /**
     * 分页查询学生数据
     *
     * @param queryDto dto
     * @return 分页后的数据
     */
    PageResult<?> pageList(StudentQueryDto queryDto);

    /**
     * 添加学生
     *
     * @param student 学生实体
     */
    void add(Students student);

    /**
     * 批量导入学生信息（Excel 文件）
     *
     * @param file 上传的 Excel 文件
     */
    void addBatch(List<Students> file);

    /**
     * 批量删除学生信息
     * @param ids 学生id
     */
    void deleteBatch(List<Integer> ids);

    /**
     * 导出学生信息
     */
    ByteArrayOutputStream exportStudents();
}
